ClawdBot v3.1 - Mac mini M4 完整安裝包 (增強版)

📋 概覽

⬇️ 下載安裝

📖 教學

❓ 常見問題

系統簡介

🗣️ 廣東話語音識別

使用 Whisper large-v3 模型，針對香港廣東話優化，支援常用口語和專業術語，識別準確度高

🤖 AI 智能對話

透過 Google Antigravity 免費贈送流量輪換，使用 Claude 等先進 AI 模型，支援多輪對話和上下文記憶

🔄 24/7 自動運行

LaunchAgent 守護進程，Mac 開機自動啟動，斷線自動重連，穩定可靠

⚡ M4 晶片優化

完整支援 Apple Silicon，Metal 加速，Whisper 語音識別性能提升 3-5 倍

🧠 智能安裝檢測

自動檢測已安裝組件並跳過，避免重複安裝和衝突，節省時間

🔧 自動更新機制

所有組件自動檢查並更新到最新版本，無需手動維護，始終保持最佳狀態

📋 系統要求

macOS 13 (Ventura) 或更高版本
Mac mini M4 或其他 Apple Silicon Mac（也支援 Intel Mac）
至少 10GB 可用磁碟空間（首次安裝需下載約 3GB 模型）
穩定的網絡連接（用於下載模型、更新和使用 AI 服務）
至少一個 Google 帳號（用於 Antigravity 免費流量）
（可選）Anthropic 或 OpenAI API Key（如需更高使用量）

💡 使用成本說明

基本使用：完全免費
透過 Google Antigravity 等服務提供的免費贈送流量（通常每月約 $10-20 USD 等值），足夠個人日常使用。系統會自動在多個帳號之間輪換，最大化利用免費額度。

進階使用：按需付費
如需更高使用量或更穩定的服務，可選擇配置付費 API Key：
• Anthropic Claude：輸入 $3/MTok，輸出 $15/MTok
• OpenAI GPT：約 $0.002-0.03/1K tokens
• OpenRouter：提供多個模型，價格較優惠

下載安裝

選擇要下載的腳本

安裝腳本：約 29KB | 驗證腳本：約 8KB

📖 快速安裝步驟

點擊上方按鈕下載 install-clawd.sh
打開「終端機」應用程式（在「應用程式」>「工具程式」中）
執行：cd ~/Downloads
執行：chmod +x install-clawd.sh
執行：./install-clawd.sh
按照提示完成安裝（約 15-60 分鐘，視網速和已安裝組件而定）
（可選）如需使用付費 API，編輯配置：nano ~/.clawd-config/.env
執行驗證：./verify-clawd.sh
啟動服務：clawd start

⚠️ 安裝前須知

首次安裝需下載約 3GB 的 Whisper large-v3 模型
安裝過程可能需要輸入管理員密碼（正常的系統安全機制）
確保 Mac 連接電源，避免安裝中斷
支援斷點續傳，可隨時中斷後繼續
已安裝的組件會自動檢測並跳過
所有組件會自動更新到最新版本

🛠️ 安裝後管理命令

clawd start - 啟動語音助理服務
clawd stop - 停止服務
clawd restart - 重啟服務
clawd status - 檢查運行狀態
clawd logs - 實時查看日誌
clawd errors - 查看錯誤日誌
clawd config - 編輯配置文件

詳細教學

第一步：準備 Google 帳號

ClawdBot 透過 Google Antigravity 等服務的免費贈送流量實現 AI 功能，您需要準備：

至少 1 個 Google 帳號（推薦 3-5 個以實現輪換）
確保帳號可正常登入和訪問 Google 服務
每個帳號通常有每月約 $10-20 USD 等值的免費額度
多個帳號可實現自動輪換，提高穩定性和使用量

（可選）準備付費 API Key

如果您需要更高的使用量或更穩定的服務，可以準備以下其中一個 API Key：

選項 A：Anthropic Claude API

訪問 https://console.anthropic.com/
註冊帳號並登入
進入 API Keys 頁面，點擊「Create Key」
複製 API Key（格式：sk-ant-xxxxx...）

選項 B：OpenAI GPT API

訪問 https://platform.openai.com/
註冊帳號並登入
進入 API Keys 頁面，點擊「Create new secret key」
複製 API Key（格式：sk-xxxxx...）

第二步：執行安裝

下載安裝腳本後，打開終端機並執行：

cd ~/Downloads
chmod +x install-clawd.sh
./install-clawd.sh

安裝過程中，腳本會：
• 檢測已安裝組件並跳過（顯示藍色 ⊙）
• 安裝缺少的組件（顯示綠色 ✓）
• 自動更新所有組件到最新版
• 下載 Whisper large-v3 模型（約 3GB）
• 配置 LaunchAgent 自動啟動服務

第三步：配置 Google Antigravity（推薦）

安裝完成後，配置 Google Antigravity 以使用免費 AI 流量：

執行 Antigravity 認證工具（安裝腳本會提示）
按照提示在瀏覽器中登入您的 Google 帳號
授權 Antigravity 訪問權限
重複此步驟添加多個 Google 帳號（推薦 3-5 個）
系統會自動在這些帳號之間輪換使用

第四步：（可選）配置付費 API Key

如果您準備了付費 API Key，可以進行配置：

nano ~/.clawd-config/.env

# 填入您的 API Key（如有）
ANTHROPIC_API_KEY=sk-ant-api03-xxxxx...
# 或
OPENAI_API_KEY=sk-xxxxx...

# 按 Ctrl+O 儲存，Ctrl+X 退出

注意：如果您使用 Google Antigravity，此步驟可以跳過。

第五步：驗證和啟動

執行驗證：./verify-clawd.sh
查看驗證報告，確保成功率 ≥90%
啟動服務：clawd start
檢查狀態：clawd status
測試語音轉錄：~/whisper.cpp/transcribe-cantonese.sh test.wav

常見問題

Q1: 什麼是 Google Antigravity？真的免費嗎？ ▼

Google Antigravity 是 Google 提供的服務，為新用戶和開發者提供免費的 AI 使用額度（通常每月約 $10-20 USD 等值）。

是的，完全免費！ 您只需要：
• 至少一個 Google 帳號
• 正常的網絡連接
• 按照安裝教學完成設置

ClawdBot 會自動管理多個 Google 帳號的輪換使用，最大化免費額度的利用。對於個人日常使用（每天約 50-100 次對話），免費額度完全足夠。

Q2: 我需要多少個 Google 帳號？ ▼

最少 1 個，但我們推薦準備 3-5 個 Google 帳號，原因：

• 更高使用量：每個帳號有獨立的免費額度，多個帳號可累加
• 更穩定：系統自動輪換，單個帳號達到限制時自動切換到下一個
• 更持久：免費額度通常每月重置，多帳號確保全月無憂

您可以使用現有的個人 Gmail 帳號，或創建新帳號專門用於此服務。

Q3: 安裝過程會要求輸入密碼嗎？ ▼

是的，某些操作需要管理員權限，例如：
• 安裝 Homebrew
• 建立軟連結到 /usr/local/bin
• 安裝 clawd 管理命令

這是正常且安全的，系統會在需要時提示您輸入 Mac 登入密碼。所有操作都是公開透明的，您可以查看安裝腳本的源碼。

Q4: 已經安裝了部分組件，會重複安裝嗎？ ▼

不會！ v3.0 版本的智能檢測功能會：

• 檢查每個組件是否已安裝
• 已安裝的組件會顯示藍色「⊙ 已跳過」
• 檢查是否有更新版本可用
• 自動更新到最新版（如有）
• 只安裝缺少的組件

您可以放心地重複執行安裝腳本，不會造成任何問題或浪費時間。

Q5: 安裝中斷了怎麼辦？ ▼

沒問題！v3.0 支援完整的斷點續傳：

1. 再次執行 ./install-clawd.sh
2. 系統會提示「檢測到先前安裝進度（步驟 X/12）」
3. 選擇 y 從斷點繼續，或 n 重新開始
4. 已完成的步驟會自動跳過

安裝進度保存在 ~/.clawd-installer/install-state.json，您可以隨時查看當前進度。

Q6: Whisper 模型下載太慢怎麼辦？ ▼

large-v3 模型約 3GB，下載時間取決於網速。建議：

1. 使用有線網絡（優於 Wi-Fi）
2. 避開高峰期（晚上 10 點後通常較快）
3. 耐心等待（通常 10-30 分鐘）
4. 支援斷點續傳（中斷後可繼續）

如果下載失敗，可手動下載：
• 訪問 Hugging Face
• 下載 ggml-large-v3.bin
• 放置到 ~/whisper.cpp/models/
• 再次執行安裝腳本，會檢測到模型已存在並跳過

Q7: 如何驗證系統是否正常運行？ ▼

使用驗證腳本進行完整檢查：

./verify-clawd.sh

驗證腳本會檢查：
• 系統環境（macOS 版本、晶片、磁碟空間）
• Homebrew 和所有依賴套件
• Node.js 和 npm 環境
• Python 和所有 Python 套件
• Whisper.cpp 編譯產物和模型文件
• 配置文件和 API Keys（如有）
• LaunchAgent 服務狀態
• 管理命令可用性
• 網絡連接

成功率標準：
• 100% = 完美運行
• 90-99% = 基本可用
• <90%=需要修復

報告會列出所有失敗項目和修復建議。

Q8: 免費額度用完了怎麼辦？ ▼

如果所有 Google 帳號的免費額度都用完了，您有幾個選擇：

選項 1：等待重置
免費額度通常每月重置，您可以等到下個月繼續使用。

選項 2：添加更多 Google 帳號
創建新的 Google 帳號並添加到 Antigravity 輪換列表中。

選項 3：配置付費 API Key
編輯 ~/.clawd-config/.env，填入 Anthropic 或 OpenAI 的 API Key。系統會自動使用付費 API。

對於個人日常使用，3-5 個 Google 帳號的免費額度通常足夠整月使用。

Q9: Intel Mac 可以使用嗎？ ▼

可以！但性能會較 Apple Silicon 差：

• Whisper 轉錄速度較慢（約 2-3 倍）
• 無法使用 Metal 加速
• 建議使用較小模型（medium 或 base）以提升速度
• 其他功能完全正常

如果您使用 Intel Mac 且覺得 large-v3 模型太慢，可以修改配置文件使用 medium 模型：
nano ~/.clawd-config/config.json
將 model_path 改為 ggml-medium.bin

Q10: 如何卸載 ClawdBot？ ▼

完整卸載步驟：

# 停止服務
clawd stop

# 移除 LaunchAgent
rm ~/Library/LaunchAgents/com.clawd.assistant.plist

# 刪除配置和數據
rm -rf ~/.clawd-config
rm -rf ~/.clawd-installer
rm -rf ~/whisper.cpp

# 移除管理命令
sudo rm /usr/local/bin/clawd

# （可選）卸載 Homebrew 套件
brew uninstall node python3 ffmpeg jq git portaudio

注意：如果您的系統中其他程式也使用這些 Homebrew 套件，請不要卸載它們。

🎙️ ClawdBot